home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / viewers / okf220 / okshow.doc < prev    next >
Text File  |  1987-04-25  |  5KB  |  88 lines
  1.  
  2.                                    OKSHOW.COM
  3.                         Basic BLOAD File Resident Viewer
  4.                                  Copyright 1987
  5.                                by Keith P. Graham
  6.  
  7.                  The OPTIKS graphics base will have, when it is 
  8.         complete, a variety of add on products. OKSHOW is the prototype 
  9.         of one of the products. OKSHOW is a resident program which 
  10.         responds to cues from the screen and from the keyboard to 
  11.         display a screen dump file which has been created by the BASIC 
  12.         BSAVE/BLOAD command pair. OPTIKS has an option (as did its 
  13.         parent PCRGB) to save in the BLOAD format also.
  14.  
  15.                  The main function of OKSHOW is to allow a simple 
  16.         interface for programs which do not handle graphics image files 
  17.         to access BLOAD screen dumps. The user has to put a simple 
  18.         message on the screen and press the "+" key that is located to 
  19.         the right of the numeric key pad OKSHOW will look at the screen 
  20.         and then display the file on the screen.
  21.  
  22.                  The most obvious use for OKSHOW is to display data 
  23.         images from within a database program. I have included a DBASE 
  24.         III .PRG file which will show all of the images in a data base 
  25.         file sequentially. It should be very easy for a good programmer 
  26.         to make a very sophisticated system for displaying a selected 
  27.         image on the screen. This is good for security systems or sales 
  28.         systems. OKSHOW, however, is not limited to DBASE. I have also 
  29.         included OPX.WKS which does nothing more than make the OPTIKS 
  30.         logo viewable through Lotus 1-2-3. OKSHOW should work with any 
  31.         program which does not alter the keyboard interrupt too much.
  32.  
  33.                  As I have said, OKSHOW is a prototype and as such is 
  34.         being tested. It may not work correctly all the time. Emily, my 
  35.         portable PC is sick and hangs up from time to time. I am 
  36.         assuming it is not because of OKSHOW, because she tends to do it 
  37.         even when OKSHOW is not running. Please be warned that this 
  38.         program uses an experimental method for issuing DOS calls from 
  39.         memory resident programs, and I am not at all confident in it 
  40.         yet. There is a danger that OKSHOW may hang or abort a program 
  41.         while you are running so always save all critical data. OKSHOW 
  42.         appears to be stable or I would not be releasing it, but treat 
  43.         OKSHOW and all public domain programs as if they are potentially 
  44.         flakey.
  45.  
  46.                  OKSHOW is the first generation of a project closely 
  47.         associated with OPTIKS that I will eventually offer for sale.
  48.         The final product will support all the graphics screens that 
  49.         OPTIKS supports, and all of the picture formats that OPTIKS can 
  50.         handle, not just BLOAD, but MacPaint and PC Paintbrush and 
  51.         Microsoft Paint. This is several months off, and my main effort 
  52.         now is to get OPTIKS rolling.
  53.  
  54.                  The trick to using OKSHOW is to have you program place 
  55.         a tilde (~) on the screen 5 rows down and 5 columns over. For 
  56.         DBASE programmers this at position 4,4 on the screen. Following 
  57.         the tilde is the name of the basic BLOAD file that you want 
  58.         loaded followed by a space. When this cue is on the screen the 
  59.         user need only to press the plus "+" on the right of the numeric 
  60.         key pad to view the picture. To return to the program the user 
  61.         must strike any key. The name of the file can have no spaces in 
  62.         it. The file name can be a complex name including disk and path, 
  63.         but it cannot be longer than 64 characters. If the file cannot 
  64.         be found or can't be opened, OKSHOW gives up and goes back to 
  65.         watching the keyboard and the screen.
  66.  
  67.                  WARNING: OKSHOW has no critical error handling routines 
  68.         so make sure that the disk drive door is not open and the disk 
  69.         you have is good. You don't want "Abort, Ignore, Retry" messages 
  70.         coming up in the middle of your graphics.
  71.  
  72.                  OKSHOW only works on CGA systems (although it will use 
  73.         CGA on an EGA). It only works for BLOAD dumps BSAVED from CGA 
  74.         screens.
  75.  
  76.                  If you have a need for the full blown system with 
  77.         support for other displays and graphics formats, complete with 
  78.         resident critical error handling and tried and tested DOS 
  79.         sharing techniques, drop me a line this summer, I should be 
  80.         looking for beta testers by then.
  81.  
  82.  
  83.                            Keith P. Graham
  84.                            238 Germonds Road
  85.                            West Nyack, New York 10994
  86.                            (914) 623-4161
  87.  
  88.